NT - miscellaneous extensions for Win32
For more information on Perl
for Win32:
- Win32mod page describes the current
set of modules for Perl for Win32
- Win32XS - issues specific to writing
module extensions for Perl for Win32 ( build 100 beta 1 )
DESCRIPTION
Go here for more information on dynaloaded
extension modules. Because Perl for Win32 originated on the Windows
NT platform, most modules extensions for Win32 exist under the
NT hierarchy. The following extensions routines are available:
- NT::GetLastError
- Returns the last error value generated by a call to a Win32
API function.
- NT::PerlVersion
- Returns a string indicating the version of NT Perl.
- NT::LoginName
- Returns the username of the owner of the current perl process.
- NT::NodeName
- Returns the Microsoft Network node-name of the current machine.
- NT::DomainName
- Returns the name of the Microsoft Network domain that the
owner of the current perl process is logged into.
- NT::FsType
- Returns a string naming the filesystem type of the currently
active drive.
- NT::GetCwd
- Returns the current active drive. This function does not return
a UNC path, since the functionality required to required for such
a feature is not available under Windwos 95.
- NT::GetOSVersion
- Returns the array ($string, $major,
$minor, $build, $id),
where the elements are, respectively; An arbitrary descriptive
string, the major version number of the operating system, the
minor version number, the build number, and a digit indicating
the actual operating system. For $id, the values
are 0 for generic Win32, 1 for Windows 95 and 2 for Windows NT.
- NT::FormatMessage
ERRORCODE
- Converts the supplied Win32 error bitmap (e.g. returned by
GetLastError) to a descriptive string. Analogous to the
perror
standard-C library function.
- NT::Spawn COMMAND, ARGS,
PID
- Spawns a new process using the supplied
COMMAND,
passing in arguments in the string ARGS. The pid
of the new process is stored in PID.
<![CDATA[ XXX =item NT::LookupAccountName SYSTEM, ACCOUNT, DOMAIN,
SID, SIDTYPE XXX =item NT::LookupAccountSID SYSTEM, SID, ACCOUNT,
DOMAIN, SIDTYPE ]]>
- NT::InitiateSystemShutdown
MACHINE, MESSAGE, TIMEOUT, FORCECLOSE, REBOOT
- Shutsdown the specified
MACHINE, notifying users
with the supplied MESSAGE, within the specified TIMEOUT
interval. Forces closing of all documents without prompting the
user if FORCECLOSE is true, and reboots the machine
if REBOOT is true.
- NT::AbortSystemShutdown
MACHINE
- Aborts a shutdown on the specified
MACHINE.